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INTRODUCTION TO THE SYSTEM 



OZDRAW is an interactive figure generation system designed to operate on the IRIS 2400 
workstations manufactured by Silicon Graphics Inc, of Mountain View, California. OZDRAW 
was written in 1985 at the Naval Postgraduate School in the Graphics and Video Laboratory of 
the Department of Computer Science. 

The aim of OZDRAW' is to provide a powerful, yet friendly, general purpose figure 
generation system to allow untrained users to produce high quality figures that can be used for 
presentations, technical papers and academic theses. OZDRAW has been designed so that the 
user can efficiently operate the system with little or no experience. The system uses pop-up 
menus to provide the user with the available instructions; menus use text rather than icons to 
provide an interface that is less ambiguous to the inexperienced user. 

The system requirements for OZDRAW are: 

(1) an IRIS 2400 workstation, ideally with three megabytes of memory and a floating-point 
accelerator, and 

(2) the IRIS mouse 

(3) a graphics printer capable of quality graphics production; a laser printer is the preferred 
printer. 

This manual is divided into the following three sections: 

(1) Section One - a very quick overview of the system, 

(2) Section Two - detailed description of the system, and 

(3) Section Three - a discussion of the particular printer currently in use. 
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SECTION ONE - A QUICK OVERVIEW. 

This section is designed for the new user who wishes to know the bare minimum to operate 
the system. This section is not recommended for those users inexperienced with computer 
systems, especially computer graphics systems. For these users it is recommended that a reading 
of Section Two and Three would be more appropriate. 

OZDRAW is envoked by the command: 

ozdraw 

Note, no command line arguments are accepted. 

OZDRAW allows two alignments of the page, either vertically or horizontally. Choice of an 
alignment for a series of figures is not binding; by writing figures to a file and then back into the 
system the alignment can be changed at any time. 

OZDRAW' is almost completely menu-driven; that is all choices are by selection of menu 
items, not by typed commands. At various times the menu selections are augmented by key- 
strokes on the keyboard. At all times OZDRAW displays the functions of the mouse buttons and 
the active keys on the screen. 

An interactive edit facility is provided by OZDRAW so mistakes during drawing can be 
quickly and easily rectified. 

Once completed, the figures must be stored in a file for later printing. OZDRAW does not 
print the file directly. A directory listing facility is provided to enable the user to view the files 
contained in his current directory. This facility cannot be used to view any other directory. 

To print the file produced by OZDRAW issue the command: 

ozprint -alignment filename [ -alignment filename ] 

where alignment is : v for a vertical alignment, and 
h for a horizontal alignment. 
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SECTION TWO - A DETAILED DESCRIPTION. 



The following section will give a detailed description of the operation and capabilities of 
OZDRAW. It is recommended that for a complete coverage of OZDRAW that Section Three 
also be read in addition to this section. 



FIGURES SUPPORTED BY OZDRAW. 

OZDRAW supports the following figures: 

(1) polygons, including rectangle and squares; 

(2) circles and ellipses; 

(3) single and continuous lines; 

(4) arcs; 

(5) a seed point to fill unconvenntional objects; 

(6) lines of text; and 

(7) arrow heads. 

For a description of the procedure to draw these figures, refer to the section "Drawing a 
Figure". 



OZDRAW FIGURE ATTRIBUTES. 

OZDRAW supports four basic attributes: 

(1) linewidth, 

(2) linestyle, 

(3) texture for filled figures, and 

(4) text fonts. 

These attributes are totally dependent on the printer currently being used. For a listing of 
possible attributes refer to Section Three. 
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Initially OZDRAW has the attributes set to the following values: 

(1) Linestyle - continuous line, 

(2) Linewidth - one pixel width, 

(3) Texture - a clear texture, and 

(4) Font - 6 lines per inch, 10 characters per inch. 

The IRIS workstations provide only one pre-defined font. Therefore, all but one of 
OZDRAW’s selectable fonts cannot be displayed as they would on the printed page. To partially 
overcome this limitation OZDRAW does the following. When any font is selected, other than the 
default font ( see Section Three ), a red rectangle is shown around the text. This rectangle 
represents the area that the text will occupy on the printed page. Note, this displayed rectangle 
can either be larger or smaller than the displayed text. 

For similar reasons OZDRAW does not realistically display all the textures that can be 
printed. OZDRAW will certainly display a clear texture as such, but most of the other textures 
will be displayed as one set texture. For a graphical representation of each texture, see the printer 
supplement at the end of this manual. 

To change attributes refer to the section ’’Changing Attributes.” 



THE PRINTED PAGE SIZE. 

OZDRAW' is designed to produce Figures for a standard paper size ( 8.5"xll" ); this size 
cannot be changed. OZDRAW’ allows the user to print the page either vertically or horizontally; 
that is either 8.5 x 11” or 11 x 8.5" respectively. 



THE IRIS MOUSE AND CURSOR. 

OZDRAW uses mainly the mouse, and to a lesser extent the keyboard, for user input to the 
system. For instance selection of menu choices is done via the mouse. 

The IRIS mouse has three buttons associated with it; these are located on the upper side of 
the mouse. These buttons are referred to in this manual and by OZDRAW as the Left, Middle 
and Right mouse buttons. Their individual locations are thus self-explanatory. Moving the 
mouse across the surface of the work-desk ( or any appropriate surface ) moves the position of the 
cursor on the terminal screen. The cursor can appear as a small pencil when in the drawing mode, 
or as a red square when the user is being asked to select an answer to a prompt. A description of 
menu items will follow later in this manual. 
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Sometimes when pressed the mouse buttons give a "double-bounce", that is it appears to the 
system that the user has pressed the mouse button two, or more, times. This occurrence can be 
annoying as it may produce results that are not expected. Therefore it is advised that the mouse 
buttons be pressed in a crisp, sharp manner to avoid this problem. 



STARTING OZDRAW 

OZDRAW is envoked by the command: 

ozdraw 

Note; no command-line arguments are used. For the path-name to locate OZDRAW within your 
system consult your local system management. 

When beginning the drawing process, OZDRAW will prompt the user for the page 
alignment. This alignment can be either vertical or horizontal; this choice is represented 
graphically so no confusion should arise. 

Choice of page alignment is not binding; at any time during the drawing process the user can 
change alignment by writing the figures to disk, changing the page alignment and then reading 
the figures back into the system. 



SCREEN LAYOUT. 

During the drawing process OZDRAW displays a portion of the intended printed page as 
well as system information and prompts. For more information on the later, refer to the section 
"System Prompts". 

OZDRAW does not display the entire page; only 8.5 x 8.4" of the page is seen at any one 
time. When using a horizontal page alignment the entire height is seen, but not all of the width. 
When using the vertical page alignment vice versa occurs; all of the width is seen, but no all of 
the height. When in a drawing or an edit function the page can be moved around, via the Arrow 
keys on the keyboard. 

Initially OZDRAW displays a grid overlaying the page; for a description of this grid refer to 
the section "The Grid Overlay" in this manual. 



7 



Superimposed on the page is a red dotted rectangle. The area within this rectangle is NOT 
the entire page; this line represents what generally is regarded as the correct margin settings for 
normal use. The choice of the size of this rectangle reflects the page layout dimensions required 
for a thesis page at the US Naval Postgraduate School. OZDRAW does not place any restrictions 
on where the user draws on the page; if required, the user can draw outside the boundaries of this 
rectangle, up to the border of the page itself. 



SYSTEM PROMPTS. 

During the drawing process OZDRAW allocates the right-hand side of the screen for system 

information and prompts. The inexperienced user is recommended to refer to these prompts 

throughout the drawing process. 

The information/prompts displayed, listed in order from the top of the screen, are: 

(1) File In Use - displays the File that is currently being produced/edited. This name is set when 
a file is read into the system; if no File has been read in then this area is blank. 

(2) Cursor Position - displays the current position of the cursor, measured in inches, from the 
lower left-hand corner of the screen. If the cursor is not in use then 0.0, 0.0 is displayed. 
Note, this display is for information only and does not have any effect on the cursor 
positioning. 

(3) Main Menu - as the name implies this is the main menu for the entire system. The functions 
selected from this menu will be described later in this manual. 

(4) Key Functions - displays which keyboard keys are active at any one time. If a key is not 
listed then it is not active; pressing an inactive key will have no effect. 

(5) Mouse Functions - lists the functions of the three mouse buttons. The buttons are identiFied 
by black squares (representing the button), with a letter inside it. The letter "L" represents 
the left mouse button, the letter M M" the middle and the letter "R" the right mouse 
buttons. 
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THE GRID OVERLAY. 



OZDRAW has the facility to overlay the displayed page with a grid. This grid is there to aid 
the user align figures on the page: this grid is not printed on the paper copy. This grid can be 
altered by the user; this option is selectable from the Draw Menu. 

The allowable settings of the grid are: 

(1) not displayed, 

(2) each grid equals one-half inch, and 

(3) each grid equals one-quarter inch, (the initial setting) 

The grid is displayed in a green colour with the half inch grid having a thicker linestyle to 
distinguish it from the quarter inch grid. 



THE MENU STRUCTURE. 

The user inputs commands to OZDRAW via a series of pop-up menus. These menus are 
organised in a hierarchical structure, as detailed in Figure 1. 

Selection of a menu command is done via the mouse buttons. The outside mouse buttons 
(left and right buttons) scroll the highlighted command up or down. This scrolling can be done 
with a series of individual mouse hits, or the button can be held down for continuous scrolling. 
Once the correct command is highlighted it can be selected with the middle mouse button. At all 
times the mouse button functions are displayed at the bottom right-hand corner of the screen. 



DRAWING A FIGURE. 

To commence drawing select the "draw" option from the Main Menu. Once selected a series 
of boxes will appear at the top of the displayed page. Inside each box will be text that describes 
the function that can be selected from this box. At this stage the cursor will appear as a red 
square; to select a box place the cursor over the box and press the middle mouse button. The 
available choices are: 

(1) Draw a Figure - draw a figure that is not a line, for example a circle, ellipse or rectangle, 

(2) Draw a Line - draw a line, including arcs, 

(3) Write a Line of Text - self-explanatory, 
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(4) Single Edit - explained in the section "The Interactive Edit Facility", 

(5) Block Edit - as above, 

(6) Attributes - refer to the section "Changing Attributes", 

(7) Toggle Grid - to change the grid overlay, see the section "The Grid Overlay", and Exit 
to Main Menu - self explanatory. 

Once selected a further menu, similar to the main menu will appear on the screen, prompting 
the user for a further choice. As always the functions of the mouse buttons will be displayed at 
the right side of the screen. 

All drawing function differ slightly in operation but are basically similar. To begin drawing 
the middle mouse button is pushed; to finish the middle button is again pushed. As usual the 
functions of the mouse buttons are always displayed. All functions are easy to use and most users 
are comfortable with the drawing process after several minutes of experimentation. However for 
completeness the following quick description of the procedure to draw each figures is given: 

(1) Rectangles - press the middle mouse button to drop the first corner of the rectangle, move 
the cursor to draw the rectangle and press the middle mouse button when finished. 

(2) Circles - press the middle mouse button to choose the centre of the circle, move the cursor 
until the circle is drawn, then press the middle mouse-button again. 

(3) Ellipses - press the middle mouse button to drop the first corner of a rectangle that will 
later contain the ellipse, move the cursor to draw the rectangle, and when finished press the 
middle mouse button; the ellipse will now be drawn. 

(4) Arcs - press the middle mouse button to choose the centre of the arc, move the cursor to 
draw the circle, press the middle mouse button when the correct radius is selected, then 
press the middle mouse button to select the start of the arc, move the cursor counter- 
clockwise and press the middle mouse button to select the angle of the arc. 

(5) Polygons - press the middle mouse button to drop the first point of the polygon, move the 
cursor and press the middle mouse button again to select subsequent points, when complete 
press the left mouse button. 

(6) Arrow Head - select the position of the arrow head by pressing the middle mouse button, 
select the direction of the arrow by aligning the line from the cursor, press the middle mouse 
button when complete and the arrow head will be drawn. 

(7) Text - choose the starting position for the text with the middle mouse button, type in the 
text followed by pressing the RETURN key, carry out the final positioning of the text, 
when complete press the middle mouse button. 
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(8) Seed Point - select the position of the seed point my pressing the middle mouse button, 
the seed point will have the texture that is currently set. 

(9) Single Lines - select the first point using the middle mouse button, move the cursor to 
complete the line and press the middle mouse button. 

(10) Continuous Lines - select the first point using the middle mouse button, move the cursor 
and the middle mouse button to drop other points, when finished press the left mouse 
button. 

During the drawing process the last figure of the type being drawn can be deleted my 
pressing the DELETE key on the keyboard. For example, while drawing circles the user decides 
the last circle he drew was not suitable, he can erase this circle by using the DELETE key. It is 
not an error to try to erase a figure that does not exist. 

Also during the drawing process, the user can reproduce the last figure drawn by pressing the 
left mouse-button. That is if the user is in the ellipse drawing function he can reproduce the last 
ellipse drawn by pressing the left mouse button. The new figure is drawn at the current position 
of the cursor and can then be moved about to position it in the correct place. 

A word of warning, the IRIS workstation cannot fill a concave polygon. When drawing a 
polygon with a filled texture the user is advised that unpredictable results may occur. 



THE INTERACTIVE EDIT FACILITY. 

The edit functions are selected via the Main Menu option "draw". Once this is selected text 
boxes appear at the top of the displayed page. For a complete description of all the choices refer 
to the section "Drawing a Figure." There are two edit choices: Single or Block Edit. 

Single edit offers the following choices: 

(1) Move a single figure, 

(2) Remove a single figure, 

(3) Recover a single deleted figure, and 

(4) Reproduce a single figure. 

Selection of individual figures is done by positioning the cursor over the "control point" of 
required figure and pressing the middle mouse button (an explanation of control points will follow 
later). If an object was found OZDRAW will cause the figure to blink; if the blinking figure is 
correct the user confirms this by pressing the middle mouse button. If it is the incorrect figure the 
user rejects it by pressing either of the outside mouse buttons. If no figure was found then an error 
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message is displayed. Once a figure has been selected then the required editing action is carried 
out. 

Block edit choices are as follows: 

(1) Move a block of figures, 

(2) Reproduce a block of figures, 

(3) Remove a block of figures, and 

(4) Move the entire page. 

Selection of a block is carried out by the user drawing a special rectangle around the 
required figures. If any figure has a control point inside this rectangle it will be selected. Once 
selected the edit action is carried out. 

The control points for the various figures are as follows: 

(1) Polygons and Rectangles - any corner. 

(2) Circles and Ellipses - the centre point. 

(3) Arcs - either end point. 

(4) Text - the first letter. 

(5) Lines - any end point or internal junction. 

(6) Seed Point - the centre point. 

Moving the entire page is straightforward; the page is reduced so that the user can see the 
entire page, and via the arrow keys all the figures on the page are moved about. This option is 
particularly useful when the user has finished drawing his figures and wishes to centre them on 
the page. 

Another function carried out by OZDRAW that could be classed as an edit function is to 
change an attribute on a previously drawn figure. This function is not chosen from the Single Edit 
menu, but instead chosen from the Attribute Menu. The selection of the figure is done via the 
above method for choosing single figures. 



CHANGING ATTRIBUTES. 

To change the current set attributes choose the Attributes text box at the top of the 
displayed page. Once selected the Attribute Menu will be displayed, from which the appropriate 
attribute can be selected to change. 

Individual figures that already have been drawn can be have their attributes altered from 
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this menu. Refer to the section "The Interactive Edit Facility" for a full description of this option. 



QUERYING ATTRIBUTES. 

OZDRAW allows the user to query attributes set either of a particular figure or of the 
current set attributes. 

The facility to view the set attributes of a particular figure is selected from the Attribute 
Menu. The user selects the figure by placing the cursor over a control point (see the section "The 
Interactive Edit Facility" for a discussion of control points) and pressing the middle mouse 
button. The attributes of that figure are then displayed on the screen. 

The facility to view the values set for the current attributes is selected from the Attribute 
Menu. Once selected the current settings are displayed on the screen. 



ERASING THE PAGE. 

Erasing the entire page can be done two ways: 

(1) remove individual figures, one at a time, using the interactive edit facility, or 

(2) erase the page in one function; this function is selected from the Main Menu. 

Note, erasing the entire page using the second option resets all attributes to their default 
values. For the value of the default attributes refer to the section "OZDRAW Figure Attributes." 



READING AND WRITING A FILE 

To print a file or save a drawing, the figures need to stored in a file. Naturally there is a 
facility to retrieve this drawing from a file. A directory listing facility is also provided; this facility 
can only list the files contained in the users current directory. Both the Read and Write 
operations are selected from the Main Menu. Both operations are similar in format; the user is 
prompted for a file name which is typed at the keyboard. 

If the user wishes to read a file OZDRAW checks two conditions: 

(1) OZDRAW checks if the file exists; if it does not exist an error has occurred and the user is 
informed. 

(2) OZDRAW checks if any figures are displayed on the screen. If there are, OZDRAW asks 
the user if he wishes to discard the displayed figures or to merge the two drawings. 
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If the user is writing to a file, OZDRAW checks if the Hie exists. If it does not then the file 
is created and the figures written to that file. If, however, the file does exist, the user is 
asked if he wishes to append the figures on the end of the file, or if he wishes to overwrite 
the file. Note, if the user chooses to overwrite the file the old contents are destroyed; be 
careful when overwriting a file. 



PRINTING A FILE. 

OZDRAW itself does not actually print the figures produced by the user. Instead 
OZDRAW produces a file, named by the user, that can be printed later by a print utility called, 
not surprisingly enough, OZPRINT. ( For those interested all printer dependent functions are 
carried out by this utility; OZPRINT must be altered for different printers that are used with 
OZDRAW. ) Consult local system management for the location of OZPRINT in your system. 

The method to print a file produced by OZDRAW is to issue the following command: 

ozprint -alignment filename [-alignment filename] 

where alignment is : h for horizontal, and 
v for vertical. 

Note that more than one file can be printed in this manner, as long as the correct number of 
alignment values are placed in the appropriate places. 

For example to print the file junkl.dwg, with a vertical alignment, as well as file junk2.dwg, 
with a horizontal alignment, the following command would be issued. 

ozprint -v junkl.dwg -h junk2.dwg 
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FILE FORMAT. 



OZDRAW stores the user produced figures in a file that uses ASCII characters. The actual 
file format is readily understandable by inspection of any OZDRAW file, so no further description 
will be given here. 

Using an ASCII file format gives the following advantages: 

(1) the OZDRAW 7 file can be edited by the user using any suitable text-editor; this approach is 
certainly only recommended for the experienced user as errors can produce unpredictable 
results, 

(2) transferring binary files between systems, such as between the IRIS and VAX 11/780, can 
be messy if systems use different sized data types, and 

(3) the ASCII format lends itself to other programmes producing complex figures, for use with 
OZDRAW 7 , that would normally be impractical to draw with OZDRAW 7 . 



EXAMPLES OF FIGURES PRODUCED USING OZDRAW. 

The next four pages are included to show to the new user what OZDRAW is capable of. 
These figures were produced by students (other than the author) for their academic theses. 
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Example 1 




Fig. 3.10 - Vector radiating from center coordinate through the 
interior coordinate towards the outer contour for tentative mapping 




Exajnple 2 






Example 3 




Example 4. 




SECTION THREE - PRINTER DEPENDENT INFORMATION 



The following is included as a supplement to detail the requirement and capabilities of the 
printer currently being used with OZDRAW. This section will be maintained by local personnel. 
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THE OZDRAW 



QMS LASER PRINTER 
SUPPLEMENT . 




OZDRAW AND THE QMS LASER PRINTER. 



This supplement to the OZDRAW is designed to detail the various attributes used with the 
QMS Laser Printer, as well as alerting the user to local peculiarities. 

Attributes. 

Currently OZDRAW can use the following attributes of the QMS laser printer: 

(1) four linestyles, 

(2) five linewidths, 

(3) sixty-one fonts, and 

(4) twenty-seven textures. 

For a graphical display of these attributes see the end of this supplement. 

The S eed Point 

When dropped a seed point will Till up to either the boundary of the page, or a solid line. Use 
this facility with caution as an error may have strange results. For example dropping a seed point 
inside a rectangle with a dotted boundary will cause the entire page to be filled. 

OZPRINT 

The print utility OZPRINT is in reality a driver programme that uses the FIG drawing 
system to draw the user’s figures. OZPRINT parses the parameters and then calls FIG and 
spawns it into the background. 

A source of error is calling OZPRINT twice, or more, in rapid succession. This error is 
caused by FIG using a scratch file to store some intermediate data. When more than one 
OZPRINT is executing at one time, collisions over this scratch file may occur, thus leading to 
errors. 

Therefore to avoid this error allow several minutes between calls to OZPRINT. This should 
not be too inconvenient as OZPRINT allows more than one file to be printed at a time. Refer to 
the OZDRAW Users manual for further discussion. 

Drawing a Filled Figur e. 

When drawing a filled figure there are two considerations to be taken into account: 

(1) OZPRINT cannot print a filled concave figure, due to the fill algorithm it uses. 
Unpredictable results may occur if this is done. 
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(2) Printing a figure that is filled with a dotted boundary will cause more than that figure to be 
filled. The algorithm in use fills up to the edge of the page or to a continuous line. 

If a filled concave figure is required then the following procedure can be used: 

(1) set the texture to clear, that is the value equal to 1, 

(2) ensure the linestyle is continuous, that is the value equal to 1, 

(3) draw the required concave figure, 

(4) set the texture to the required fill pattern, 

(5) drop a seed point inside the concave figure. 

Clipping of Figures 

The user is to be aware that OZDRAW does not undertake any clipping of figures produced 
during a drawing session. Therefore the figure produced may be stored in the file with portions of 
this figure lying outside the bounds of the page. Certainly there is no problem with this, but when 
the user attempts to print the figures on the QMS unpredictable results may occur. It appears 
that the QMS printer can handle figures that overlap the right-hand and the top edges. However, 
the lower and left edges are not as understanding; unpredictable therefore results may occur on 
these two edges if figure project off the page. 
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AVAILABLE TEXTURES FOR OZDRAW 
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OZDRAW’S AVAILABLE LINEWIDTHS 
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